home *** CD-ROM | disk | FTP | other *** search
/ Aminet 4 / Aminet 4 - November 1994.iso / aminet / comm / bbs / cd_rom.lha / Doors / CDRomDoor / CDROMDoor.doc < prev    next >
Text File  |  1993-11-30  |  4KB  |  95 lines
  1.  
  2.                                CD ROM Door v1.00
  3.                                ~~~~~~~~~~~~~~~~~
  4.                         Copyright c 1993 Murray Chaffer
  5.  
  6.                              Freely Redistributable 
  7.                             Source avail. on request
  8.  
  9.                             A Door for MAXSBBS 1.52+
  10.  
  11.    Hi Ross..
  12.             At the moment this door is obviously a one off project, but I
  13.    hope to see it expanding into a popular door for MAXS in the future..
  14.    unfortunately it's not a great example of the programmers craft, and
  15.    has loads of GOTOS and other really nasty stuff that shouldn't be in well
  16.    written programs, but at least it seems to work nicely in practice.
  17.  
  18.    What does it do ?
  19.    ~~~~~~~~~~~~~~~
  20.       It allows sysops to put CD ROM disks online without having to go to
  21.     the trouble of adding all files on every disk to the MAXS file.data..
  22.     in a sense it's almost an alternative files area manager on a slightly
  23.     less sophisticated scale.. each disk has its own config file from which 
  24.     data on the disk and 'sections' is stored.. I will explain briefly the 
  25.     config file format here..
  26.  
  27.     Must be in doors path in a directory CDROMDoor and named as Disk.cfg
  28.  
  29.     ie BBS:Doors/CDROMDoor/Disk.cfg
  30.  
  31.     You may want to setup several Disk.cfg files ie NightOwl9.cfg , then use
  32.     a script to copy it over and rename or something like that I guess
  33.     would be a convenient way of tackling things.
  34.  
  35.     ******************************************************************************
  36.     Line  1 : Device Name of CD ROM Drive (ie CD0:)
  37.  
  38.               This is the default path for which files/dirs will be searched.
  39.  
  40.     Line  2 : Name of Current Disk
  41.  
  42.               Displayed only for the interest of the user..  
  43.  
  44.     Line  3 : Name of 'Next' Disk (optional) or *BLANK LINE* 
  45.     Line  4 : Date of 'Next' Disk (optional) or *BLANK LINE*
  46.  
  47.               These two (If filled in) will be displayed at the bottom of the
  48.               CD ROM Door screen, to allow you to let the user know which disk 
  49.               will be coming up next, and when.. Allows you to have disks on a 
  50.               rotating basis and makes it a little less painless.
  51.               Remember to include 2 blank lines if not utilising this feature.
  52.  
  53.     Line  5 : Number of sections on Current Disk
  54.  
  55.               Most CD ROMS are conveniently divided into 'sections' - this 
  56.               value represents the number of 'sections' (usually in dirs)
  57.               on this disk.
  58.  
  59.     Line  6 : <Section Name>  <Path to listing file>   <Path to section>
  60.  
  61.               Repeat for number of times needed (ie value in line 5)
  62.  
  63.               Now you must make up an entry for each 'section', 1 line each, 
  64.               with section name, a path & name to a text/ANSI listing of
  65.               files in that section (usually included on disk somewhere),
  66.               and a path to the 'section' (remember Device name is 
  67.               assumed as default for both dir and for listing file.) 
  68.               each of these MUST be in quotes.. no commas are needed to 
  69.               separate the strings, just like this :
  70.  
  71.               "Name"   "Listing File"   "Path"
  72.           
  73.                No quotes needed for first 5 lines.
  74.  
  75.    How do I use it ?
  76.    ~~~~~~~~~~~~~~~
  77.          Anyway you like! Play around with it and if you don't like something, 
  78.     drop me a line... There's bound to be a few bugs, due to the fact that I
  79.     don't have a CD ROM drive to test this sucker on !
  80.    
  81.  
  82.  
  83.       * Hope this one is handy.. - Any probs/bugs/ideas, contact me here:
  84.              ____
  85.          __ /_/  \  
  86.         / /\\_\/\ \   Murray Chaffer      Continental Drift BBS NSW Australia
  87.        /_/ /_ /_/ /  
  88.        \ \ \/\\_\/    BBS +61 2 918 8375   FIDO 3:714/911.0  
  89.         \ \  /      Voice +61 2 918 8153   MAXS 3:30000/76.0                                 
  90.          \_\/
  91.  
  92.  
  93.                                       Cheers...
  94.                             Muzz
  95.